package cn.iocoder.yudao.module.book.service.category;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.book.controller.admin.category.vo.*;
import cn.iocoder.yudao.module.book.controller.app.category.vo.AppCategoryRespVO;
import cn.iocoder.yudao.module.book.controller.app.category.vo.AppCategoryDetailRespVO;
import cn.iocoder.yudao.module.book.dal.dataobject.category.CategoryDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 分类 Service 接口
 *
 * @author xi
 */
public interface CategoryService {

    /**
     * 创建分类
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Integer createCategory(@Valid CategorySaveReqVO createReqVO);

    /**
     * 更新分类
     *
     * @param updateReqVO 更新信息
     */
    void updateCategory(@Valid CategorySaveReqVO updateReqVO);

    /**
     * 删除分类
     *
     * @param id 编号
     */
    void deleteCategory(Integer id);

    /**
     * 获得分类
     *
     * @param id 编号
     * @return 分类
     */
    CategoryDO getCategory(Integer id);

    /**
     * 获得分类分页
     *
     * @param pageReqVO 分页查询
     * @return 分类分页
     */
    PageResult<CategoryDO> getCategoryPage(CategoryPageReqVO pageReqVO);


    AppCategoryRespVO selectByCategoryId(Integer id);

    List<AppCategoryRespVO> selectByClassifyId(Integer classifyId);

    /**
     * 获取分类详情列表（包含绘本集信息）
     *
     * @param userId 用户ID
     * @return 分类详情列表
     */
    List<AppCategoryDetailRespVO> getCategoryDetails(Long userId);
    
    /**
     * 根据大分类ID获取层级数据
     *
     * @param classifyId 大分类ID
     * @param userId 用户ID
     * @return 分类详情列表
     */
    List<AppCategoryDetailRespVO> getCategoryHierarchyByClassifyId(Integer classifyId, Long userId);
    
    /**
     * 获取绘本集下的所有图书和图片信息
     *
     * @param collectionId 绘本集ID
     * @return 图书和图片信息
     */
    List<java.util.Map<String, Object>> getBooksWithImagesByCollectionId(Integer collectionId);
    
    /**
     * 根据语言参数获取分类层级数据
     *
     * @param isEnglish 语言参数：0-中文，1-英文
     * @return 分类层级数据
     */
    List<cn.iocoder.yudao.module.book.controller.app.category.vo.AppLanguageCategoriesRespVO> getCategoriesByLanguage(Integer isEnglish);
}